(PHP 4 >= 4.0.5, PHP 5)
array_search — Busca un valor determinado en una matriz y devuelve la clave correspondiente en caso de éxito
Busca en el pajar por la aguja .
El valor a buscar.
Note: Si aguja es una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.
La matriz.
Si el opcional tercer argumento, estricto , se define como TRUE entonces la función array_search() también realizará un chequeo sobre los tipos de datos de aguja en el pajar .
Devuelve la clave de la aguja si se encuentra en la matriz, o FALSE de lo contrario.
Si la aguja es encontrada en el pajar más de una vez, la primera clave coincidente es devuelta. Para devolver las claves de todos los valores coincidentes, use en su lugar array_keys() con el parámetro opcional valor_busqueda .
Esta función puede devolver FALSE, pero también puede devolver un valor no-booleano que será evaluado FALSE, como por ejemplo 0 o "". Por favor, lea la sección Booleans para más información. Utilice el operador === para comprobar el valor devuelto por esta función.
| Versión | Descripción |
|---|---|
| 4.2.0 | En versiones de PHP anteriores a 4.2.0, array_search() devuelve NULL en caso de fallo, en lugar de FALSE. |
Example #1 Ejemplo de array_search()
<?php
$matriz = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$clave = array_search('green', $matriz); // $clave = 2;
$clave = array_search('red', $matriz); // $clave = 1;
?>